---
title: PdfTrackingInfo
summary: API reference for PdfTrackingInfo.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-17
library: PdfAPI.Core
reference_type: package
---

# PdfTrackingInfo

`PdfTrackingInfo` is an immutable snapshot of a document's tracking state — its file identity, path, status, and tracking record id — exposed to callers that need a read-only view without the mutable fields of `PdfResult`.

## Purpose
- Provides a read-only snapshot pairing a `Document`'s identity and path with its tracking id and `PdfStatus`.

## Context
- Namespace: `PdfAPI.Core`
- Assembly/package: `PdfAPI.Core`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| FileId | `Guid FileId { get; }` | The identity of the tracked document. |
| FilePath | `string FilePath { get; }` | The on-disk path of the tracked document. |
| Status | `PdfStatus Status { get; }` | The current lifecycle status of the tracked operation. |
| TrackingId | `long TrackingId { get; }` | The tracking record identifier. |
| PdfTrackingInfo(long, PdfStatus, Document) | `PdfTrackingInfo(long trackingId, PdfStatus status, Document document)` | Public constructor building a snapshot from a tracking id, status, and document. |

## Behavioral notes
- All properties are read-only, so a `PdfTrackingInfo` cannot be mutated after construction; a new instance must be created to reflect a status change.*
- A second, `internal` constructor decorated with `[JsonConstructor]` supports deserialization without exposing a public parameterless constructor.

## Constraints and usage notes
- Package consumers can only construct this type via the public `(long, PdfStatus, Document)` constructor or receive it via deserialization.

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts.

## Related documentation
- [Index](../../index.md)
- [Overview](../../overview.md)
- [Architecture](../../architecture.md)
- [Dependencies](../../dependencies.md)
- [Operations and processes](../../operations-processes.md)
- [Business rules](../../business-rules.md)
- [Security and authorization](../../security-authorization.md)
- [API reference](../index.md)

## Sources
- `PdfAPI.Core\PdfTrackingInfo.cs`